home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Overload Trio 2
/
Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO
/
dir37
/
main120.zip
/
MAINMENU.DOC
< prev
next >
Wrap
Text File
|
1993-06-18
|
15KB
|
291 lines
TSB SYSTEMS PRESENTS
┌───────┐ ┌──────┐ ┌───┐ ┌──┐ ┌─┐ ┌───────┐ ┌─────┐ ┌──┐ ┌─┐ ┌─┐ ┌─┐
│ ┌┐ ┌┐ │ │ ┌──┐ │ └┐ ┌┘ │ └─┐ │ │ │ ┌┐ ┌┐ │ │ ┌───┘ │ └─┐ │ │ │ │ │ │
│ ││ ││ │ │ └──┘ │ │ │ │ ┌┐ └┐│ │ │ ││ ││ │ │ └─┐ │ ┌┐ └┐│ │ │ │ │ │
│ │└─┘│ │ │ ┌──┐ │ │ │ │ │└┐ └┘ │ │ │└─┘│ │ │ ┌─┘ │ │└┐ └┘ │ │ │ │ │
│ │ │ │ │ │ │ │ ┌┘ └┐ │ │ └─┐ │ │ │ │ │ │ └───┐ │ │ └─┐ │ │ └──┘ │
└─┘ └─┘ └─┘ └─┘ └───┘ └─┘ └──┘ └─┘ └─┘ └─────┘ └─┘ └──┘ └──────┘
A COMPLETE MENUING SYSTEM
VER 1.20 06-18-1993
REQUIRED FILES:
Tsbmenu .Bat - You MUST use this to start
Mainmenu.Cfg - Configuration File
* .Dat - Menu data files
Mainmenu.Exe - Main program
-------------------------------------------------------------------------------
HARDWARE:
Graphics: EGA (640x480) or VGA
CPU : The faster the better (386 at least)
MOUSE : Microsoft compatible (not required)
-------------------------------------------------------------------------------
SETUP:
ALL of the files listed above MUST be in the directory defined in
the configuration file for the program to operate correctly.
Make a directory named C:\MENU. Copy all the files to this dir. Run
Tsbmenu.Bat. If changing the program path edit Mainmenu.Cfg (line 3)
or see MAINMENU.CFG, F3-C.
-------------------------------------------------------------------------------
GENERAL:
* Up to 230 items (10 M's x 23 S's) per menu file. Up to 15 commands
'B' can be entered for each item. If command is a .Bat file you MUST
use the CALL command (or Command /c filename) to return to the menu.
To make a selection, use the arrow keys or press the highlighted key
then <ENTER>, or double-click on selection with left mouse button.
When a main category is already open, using the left or right arrow
keys will open the adjacent category (or click on new main category
name with left mouse button). Your previous select location will be
remembered until you press ESC twice (or load a new menu file) which
closes the category and resets all locations to the first selection.
ESC, when no submenu is open, will clear ALL locations in sub menus.
If you use a parameter, with Tsbmenu.Bat it will a load any menu
file (.Dat) and ignore, but not change, the current default name.
Example: Tsbmenu games (games.dat MUST already exist)
F4 calls your External editor (if not in the path, AND not in the
configuration directory you MUST specify the full pathname) to edit
.Dat files. If you edit your current .Dat file it will reload your
edited file.
<SPACE> or moving mouse to upper-right corner, will blank the screen
immediately. Pressing any key, or clicking right mouse button will
exit the blanker. If Sys password is active, (does NOT = NONE) you
will be required to enter a password to return to the menu. Either
password (Sys or Key) will work here. This is true whether blanker
is activated by the space bar or by elapsed time.
F7 is a "hidden" feature which provides screen blanking, with return
to the menu requiring the Key password (ONLY). If the Key password
is not active then it will do nothing.
F10 is a "hidden" feature for displaying pop-up tsr's.(see TECHNICAL)
Will currently list up to 155 available menu (.Dat) files on screen.
The left button (only 2 buttons are currently supported) on the mouse
simulates <ENTER>, the right button simulates <ESC>.
-------------------------------------------------------------------------------
MAINMENU.CFG - Format (see examples):
Contains Password(s), Drive:\ Path to menu files, default .Dat file,
Menu Log information, External editor name, Screen blank time, the
Command to execute on Exit and Color information.
The password is for the function keys and specified 'S'ubmenus and
can be up to 16 characters. If password try goes past 3 will give
message and 1 more try (if present you MUST use the 'KEY' password)
or the system will lock. If a submenu item is password protected
there will be an asterisk (*) to the left. If you need a separate
password for the Function keys than you have for the submenus, use
the 'KEY' password. This password will work for Function keys OR
Submenus, the other will be for Submenus ONLY. If the password in
configuration = NONE then that password is disabled.
* If changing the program path (F3-C), all relevant files MUST already
exist in the NEW path (make sure line 3 reflects the proper path in
ALL directories). The NEW .Cfg file will be used although all other
changes (F3) will be recorded in the old .Cfg. This allows you to
have a separate group of .Dat files with a separate configuration in
an alternate directory.
The Drive MUST be specified along with the Path. Example: C:\MENU
The menu Log tracks the date, time and commands used for each menu
selection and can be turned ON or OFF.
The Exit command is what will be executed when you Quit the menu. To
disable this feature it MUST equal NONE.
Color information is the customized colors for the menu system.
-------------------------------------------------------------------------------
MAINMENU.DAT - Format (see examples):
'M' = Main item/Password 'S' = Sub item/Password 'B' = Command/Parm
'L' = Load menu 'T' = Title 'E' = End/Drive
'-' = Comment (dash)
ALL descriptors & first letter of 'M' & 'S' items MUST be upper case.
'E' indicates the END of the menu file and MUST be present. If not
blank, it also specifies drive to change to for the WHOLE menu file
before running a command. IF present, specifier will be added to ALL
selections (except Function keys) prior to any other commands.
If '-'(dash) is used it allows non-displayable comments in menu file.
When 'S' is a string of '─' [chr$(196)], this item will be printed
on the menu and count toward item count (230) but will be skipped
when arrowing up or down. DO NOT put at the end of a category OR one
on top of another (2 of these together).
If 'S' is followed immediately by a 1 ('S1') then this subitem is
protected by the System Password in the configuration.(see examples)
If 'M' is followed immediately by a 1 ('M1') then ALL subitems in
that category are protected by the System Password. (see examples)
If 'B' is followed immediately by a P ('BP') then you MUST provide
parameter TEXT enclosed in quotes and limited to 30 characters. You
will be prompted with this text for a parameter to use with (add to)
the command that follows. (see examples)
If 'L' is used instead of 'B', program will load another .Dat file.
The 'L' command MUST be the ONLY command for that sub item.
If 'T' is used it displays a "double-spaced" title. You may want to
put extra spaces between words. The title is displayed when file is
initially loaded or when no main category is selected.
-------------------------------------------------------------------------------
TECHNICAL:
There are actually three parameters: menuname, column, row to open.
* Program uses screen mode 12 (640x480). Because of this MOST memory-
resident pop-ups will not pop up through the menu environment. The
"hidden" F10 key feature has been provided for this reason. F10 will
change you to standard text mode (screen mode 0), and wait for a key
press. At which time, you WILL have access to your pop-up programs.
Program exits with screen mode 0.
Rewrites Tsbmenu.bat for 256 byte memory usage. Totally unloads from
memory for execution of ALL commands except F1 and F4. F1 (Dos Cmd)
and F4 (Editor) are shells and can use up to 106K of memory plus the
size of your editor program or dos command.
Uses symbol # internally. Do NOT use ANY commands that begin with #.
If too many items in menu, it will exit with a location number:
L = Main Titles (M's) LO = Subtitles (S's) LOO = Commands (B's)
When the menu is visible you're ALWAYS in the dir defined in config.
Ctrl-Break or Ctrl-C has not been totally disabled. If you are at an
input prompt, (ie: F1, F2 or F4), if the keys Ctrl-Break or Ctrl-C
are pressed, if it's the first selection made, will allow an exit to
DOS, if not then the last selection made will be performed again. To
avoid security breeches, password function keys with a Key password.
Written and compiled with Quickbasic 4.5.
-------------------------------------------------------------------------------
EXAMPLES:
Mainmenu.Cfg PASSWORD - Function key password only
NONE - System password is disabled
C:\MENU - Path to program files
MAINMENU - Default .Dat file to load
OFF - Log has been turned off
LOG.MNU - Default log filename
EDIT.COM - External editor name
3 - Minutes to screen blanker
NONE - Disabled 'on exit' command
7 - Main screen color
1 - Header color
11 - Border color
14 - Highlighted letter color
10 - Highlighted text color (bar)
7 - Non-highlighted text color
15 - Menu text color
-----------------------------------------------------------------
Mainmenu.Dat T MAIN MENU - Title
M Utilities - Main category
S Quit - Sub item (not protected)
B exit - Command
S ───────── - Displayable separator
S1Dos shell - Password protected (NO spaces)
B command
S Norton's utils - not protected
B cd\norton
B command /c nt - "Called" .Bat file (see GENERAL)
---------------- - Non-displayable comment/separator
M1Disk - ALL S's under this are protected
S Format a:
BP"Enter Paramater: "format a: - user parameter (like - \s)
S Format b:
B format b: \s
E D: - Change to drive D: for whole file
-------------------------------------------------------------------------------
D I S T R I B U T I O N
You are encouraged to freely distribute copies of this program subject
to the following conditons:
A. No renumeration may be accepted for this program or accompanying
files. This does not include system access fees which may apply
to subcribers of bulletin board systems, online services, etc...
B. Program must be copied in unaltered form, complete with license
information, FULL documentation and all accompanying files.
C. All shareware houses / distribution firms must make it explicitly
clear that the diskette purchased containing this program does NOT
include registration of the program and the accompanying files.
This program and the accompanying files may not be circulated in any
incomplete or modified form, nor sold or distributed for profit without
the express and written permission of the author.
Commercial distributors may distribute this program / files, subject
to the above conditions, only after obtaining WRITTEN permission from
the author. This condition statement supersedes all previous agreements.
-----------------------------------------------------------------------------
L I C E N S I N G a n d D I S C L A I M E R
MAINMENU is defined as this program and all of its accompanying files.
MAINMENU is distributed on an "As-is" basis, with no warranties
expressed or implied. The author and distributors assume no liability
for damages, either from the direct use / registration of this product
or as a consequence of the use / registration of this product.
MAINMENU may NOT be modified in any respect, for any reason, including
but not limited to, de-compiling, disassembling or reverse engineering
of the program. The opening title screen and all other proprietary
program output must never be altered, removed, bypassed or modified by
any means.
Any corporation or institution wishing to use this program / files in
the course of its business must purchase a SITE LICENSE. A standard
license which allows usage on up to 20 different computers. A disk with
the latest release will be included at no additional charge. (Please
specify 360k, 720k, 1.2 or 1.44 disk).
Non-registered users are granted a limited license(30 days) to evaluate
the programs suitability for their requirements. Any usage beyond the
30 day evaluation time period requires registration of each copy of the
program used. Use of non-registered copies beyond the evaluation period
is prohibited.
To ensure continued quality products and upgrades ...PLEASE REGISTER...
A program license for non-commercial use on one machine is only $24.95.
-----------------------------------------------------------------------------
For bulk rate discount, custom tailored version, Site License, helpful
suggestions and/or comments, information, upgrades or technical support
(registered users only), or to register (send version number and check
payable to: Terry Bever) contact:
TSB SYSTEMS
P.O. BOX 2448
BRADENTON, FL 34208
(End-of-File) ---------------------------------------------------------------